Skip to content

Organize skills with expo-* and eas-*#98

Merged
jonsamp merged 2 commits into
mainfrom
jon/reorg-skills
Jul 7, 2026
Merged

Organize skills with expo-* and eas-*#98
jonsamp merged 2 commits into
mainfrom
jon/reorg-skills

Conversation

@jonsamp

@jonsamp jonsamp commented Jul 2, 2026

Copy link
Copy Markdown
Member

Why

We're adding many skills and our naming conventions and patterns have started to sprawl.

This PR makes some changes to organize them:

  • Prepend every skill with either expo-* or eas-*. This helps discovery since you can type /expo- and then you'll see all related skills. Also creates a clear boundary btw free/paid.
  • Renames skills to match product names that are more established.
    • building-native-ui → expo-router
    • native-data-fetching → expo-data-fetching
    • use-dom → expo-dom
    • web-to-native → expo-web-to-native
    • add-app-clip → expo-app-clip
    • upgrading-expo → expo-upgrade
    • expo-observe → eas-observe
    • expo-cicd-workflows → eas-workflows
    • expo-deployment → eas-app-stores
      • Previously included web deploy info, separated that out into eas-hosting.
    • expo-api-routes → eas-hosting
  • All skill descriptions have Framework (OSS) or EAS service (paid).
  • Adds a contributing guide with patterns documented, like how to test your skill.
  • CI enforces conventions, like skill character limits.

Fixes ENG-23102

Breaking changes

There are no aliases for the old names for skills cli installations. So anyone who has installed /building-native-ui will no longer get updates. I don't think there's a way around this.

Test plan

Please look at the skils and make sure they seem reasonable. Let me know if there are naming conventions/etc that you think we should change.

The new README is probably the best place to start: https://github.com/expo/skills/blob/bd295c4c5038247d6991aeac1e2d438118df62d1/README.md

@jonsamp jonsamp marked this pull request as ready for review July 3, 2026 04:53
@jonsamp jonsamp requested review from Kudo and davidmokos July 3, 2026 04:53
@Kudo

Kudo commented Jul 5, 2026

Copy link
Copy Markdown
Contributor

i feel building-native-ui is too large and not making sense map to expo-router directly. for instance, the webgpu-three.md isn't related to router.

maybe wait #99 to land first so we would be have clear expo-router skill then

Prefix every skill with expo-* (framework/OSS) or eas-* (paid EAS
service), and prefix each description with "Framework (OSS)." or
"EAS service (paid)." so the free/paid boundary is visible in the
always-loaded metadata and /expo- / /eas- discovery works.

Renames to established product names:
- building-native-ui (visual guide) -> expo-native-ui; navigation
  stays in the expo-router skill, matching the #99 split
- native-data-fetching -> expo-data-fetching
- use-dom -> expo-dom
- web-to-native -> expo-web-to-native
- add-app-clip -> expo-app-clip
- upgrading-expo -> expo-upgrade
- expo-observe -> eas-observe
- expo-cicd-workflows -> eas-workflows
- expo-deployment -> eas-app-stores (web deploy split into eas-hosting)
- expo-api-routes -> eas-hosting

Add CONTRIBUTING.md with documented patterns, CI checks for skill
limits and plugin version bump, and bump the expo plugin to 1.7.0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@jonsamp jonsamp force-pushed the jon/reorg-skills branch from 4529562 to 4ab8194 Compare July 6, 2026 15:33
@linear-code

linear-code Bot commented Jul 7, 2026

Copy link
Copy Markdown

ENG-23102

@davidmokos davidmokos left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the new structure is really good. I think some skills are still a bit too long but we should cover that in follow-up PRs

Comment thread plugins/expo/skills/expo-data-fetching/SKILL.md
@jonsamp jonsamp merged commit b2fdce7 into main Jul 7, 2026
2 checks passed
@jonsamp jonsamp deleted the jon/reorg-skills branch July 7, 2026 16:18
@Kudo

Kudo commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

late review but i do think we may need some further rename. e.g. expo-native-ui vs expo-ui feels unclear.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants